home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / Tools / SFX-Player / DiamondGUI / DiamondGUI.doc < prev    next >
Text File  |  2000-05-08  |  10KB  |  267 lines
  1.  
  2.                       Diamond GUI v1.1 (29.10.1997.)
  3.  
  4.                       (c) 1997 by Dejan Stepanovic
  5.  
  6.  
  7.            MPEGA is an MPEG Audio decoder (Layers I, II & III)
  8.                        (Aminet:mus/play/MPEGA.lha)
  9.                       (c) 1997 by Stephane Tavenard
  10.  
  11.  
  12.  
  13. Distribution conditions:
  14.  
  15.   This program is copyrighted by Dejan Stepanovic.
  16.  
  17.   It may be distributed freely under the condition that no profit is
  18.   gained from its distribution.
  19.  
  20.   It may be put on public domain disks or included in public domain
  21.   program collections only with my permission, nevertheless it must not
  22.   be sold commercially as a single program.
  23.  
  24.   All files that are part of this package have to be distributed
  25.   together and none of them may be changed in any way other than
  26.   archiving or crunching.
  27.  
  28.  
  29. Disclaimer:
  30.  
  31.   Use this program at your own risk. I'm not responsible for any damage
  32.   which it may cause.
  33.  
  34.  
  35. Introduction:
  36.  
  37.   Diamond GUI is a freeware graphic user interface for great MPEGA player
  38.   created by Stephane Tavenard. At this time there are few programs with
  39.   same purpose, but no one fulfills all my demands, so I decided to make
  40.   one which will support more parameters and will be more usable. Current
  41.   version supports version 3.3 of MPEGA.
  42.  
  43.  
  44. Requirements:
  45.  
  46.   - MPEGA v3.3 - can be found on Aminet:mus/play/MPEGA.lha
  47.  
  48.   - Kickstart 2.0+
  49.  
  50.   - display fonts (included)
  51.  
  52.   - reqtools.library ((c) by Nico François and Magnus Holmgren; can also
  53.     be found on Aminet)
  54.  
  55.  
  56. Installation:
  57.  
  58.   Copy the program and documentation where ever you want and put the
  59.   included fonts into FONTS: directory.
  60.  
  61.  
  62. Features:
  63.  
  64.   - LCD like display with the most important informations (time, total
  65.     time, status, track name and info...)
  66.  
  67.   - easy controlable playing functions
  68.  
  69.   - main panel selectable playing options
  70.  
  71.   - real-time changing parameters (changing speed, of course, depends on
  72.     priority, processor speed and compression method)
  73.  
  74.   - forward/backward in track positioning via slider with automatic time
  75.     and percentage calculating and displaying
  76.  
  77.   - multitrack selection
  78.  
  79.   - track repeating and random choosing
  80.  
  81.   - convert window for converting MPEG to AIFF, WAV or PCM file, with
  82.     progress bar, and start/stop position slider
  83.  
  84.   - preferences window which features other more important MPEGA settings
  85.  
  86.  
  87. Usage:
  88.  
  89.   When you start the program, you will see a window with these
  90.   gadgets/buttons:
  91.  
  92.  
  93.    Play   - Start playing track. If the track is not loaded, it will
  94.             open requester and after selection will start to play it
  95.             automatically. Using this gadget during the play will
  96.             restart the track.
  97.  
  98.    Prev   - Position to the previous track. If you chose more files,
  99.             this function will position program to the previous one.
  100.  
  101.    Next   - Position to the next track. If you chose more files, this
  102.             function will position program to the next one.
  103.  
  104.    Pause  - Pause playing. 'Play' gadget will continue it.
  105.  
  106.    Stop   - Stop playing. Will reset time and percentage counters and
  107.             move slider to the beginning.
  108.  
  109.    Eject  - Eject the current tracks and open requester to select the
  110.             next ones.
  111.  
  112.  
  113.   With the slider at the bottom of the window you can jump to any
  114.   position of the track. Moving it directly with the mouse or clicking
  115.   inside its field can achieve this operation during the reproduction.
  116.   Moving by the arrows operate only in the Stop and Pause mode. In those
  117.   modes time display will be refreshed instantly.
  118.  
  119.  
  120.   Buffer  - This option will wait for audio buffer to be full before
  121.             starting audio play. Size of the buffer can be changed in the
  122.             preferences window.  When it is turned ON it will show current
  123.             buffer status (in seconds) on display so you will be able to see
  124.             when the buffer is full or empty.
  125.             This is usefull for users with slower CPUs, because you can
  126.             get better listening quality, but this requires a lots of RAM
  127.             for buffer, and you will have to wait before song start to play.
  128.  
  129.   Stereo  - Turn the stereo mode on/off.
  130.  
  131.   Filter  - Turn the sound filter on/off.
  132.  
  133.   Quality - Choose the output quality (Low, Medium or High)
  134.  
  135.   Frequency - Choose the number by which the track's sampling
  136.   division    frequency will be divided (x1, x2 or x4)
  137.  
  138.   Random  - Play random selected track. In this case 'Next' means 'next
  139.             random track'.
  140.  
  141.   Repeat  - Start playing again after the end of the last track
  142.  
  143.  
  144.   On the right side of the window is the volume scroller. You can set the
  145.   volume value either the track is playing or not.
  146.  
  147.  
  148.   R       - Reset volume scroller to default value (64)
  149.  
  150.   ?       - Just some informations about the author and the current
  151.             version of the program
  152.  
  153.   Prefs   - Open preferences window. I think that most of these options
  154.             are self-explainable and there is no need for special
  155.             descriptions. If you can't understand them, please consult
  156.             MPEGA manual.
  157.  
  158.             'Reset' - Return previously used settings.
  159.  
  160.             'Save'  - Save settings from both windows.
  161.  
  162.             All functions from the preferences window are activated
  163.             immediately after set up. You can reset them until 'Save'
  164.             button is used.
  165.  
  166.   Convert - Open convert window. Here you can choose type of converted file
  167.             (AIFF, WAV or PCM), quality, start/end position for convert, etc.
  168.             If you turn OFF silence button, song will play while converting.
  169.  
  170.  
  171.   IMPORTANT NOTE: If you use MPEGA configuration file, you need to know
  172.                   that its parameters will be called at last, which means
  173.                   that these set by the GUI won't be performed. I could
  174.                   make an empty cfg file and call it every time but think
  175.                   that wouldn't be a proper solution. The best way to
  176.                   handle this is renaming your cfg file and using it with
  177.                   the '-c' option.
  178.  
  179.  
  180. History:
  181.  
  182.   04.08.97.          -  Started coding.
  183.  
  184.   05.08.97.          -  Internal release, actually not really usable.
  185.  
  186.   07.08.97. (v0.2)   -  Fixed some bugs, fixed time measuring, added
  187.                         display, slider and real-time commands. Many other
  188.                         small improvements.
  189.  
  190.   08.08.97. (v0.4)   -  Fixed bugs in display, added 'Frequency division'
  191.                         buttons, fixed slider moving, added 'Quality'
  192.                         buttons, fixed time measuring (now should work
  193.                         okay)
  194.  
  195.   09.08.97. (v0.5)   -  Disabled slider moving by one click while playing,
  196.                         added 'Volume' scroller, added 'Reset volume to
  197.                         default' button, some minor improvements.
  198.  
  199.   10.08.97. (v0.6)   -  Added 'Repeat' button, blinking playing status
  200.  
  201.   12.08.97. (v0.7)   -  Minor changes on display, added multitrack
  202.                         selection, 'Filter' and 'Random' buttons
  203.  
  204.   15.08.97. (v0.8)   -  Buttons redesigned. First public release.
  205.  
  206.   23.08.97. (v0.9)   -  Fixed to work with MPEGA v3.2 (header was changed).
  207.                         Added preferences window and 'Save configuration
  208.                         on exit' button.
  209.                         Added 'Process priority' slider (don't set
  210.                         priority too high because you won't be able to
  211.                         stop the track, or you'll have to wait a lot.
  212.                         Priorities -1 and 0 are the best choices if you
  213.                         have a slower Amiga)
  214.                         Added 'Max. decoding frequency' and 'Audio mixing
  215.                         frequency' sliders. Added 'Default track path'
  216.                         and 'Default MPEGA path' requesters as well.
  217.                         Added 'Save' and 'Reset' buttons and fixed a bug
  218.                         with saving configuration.
  219.  
  220.   18.09.97. (v1.0)   -  Fixed to work with MPEGA v3.3. Some code
  221.                         optimizations. Added input file buffer slider and
  222.                         AHI support (if you don't have AHI installed,
  223.                         option will be disabled). Ad